Release 10.1A: OpenEdge Development:
Debugging and Troubleshooting

Preferences dialog box

The Preferences dialog box lets you set user preferences for the Debugger window. Access this dialog box by choosing Edit Preferences.

The Preferences dialog box has three tabs:

Font tab — Lets you set the Debugger font and size.
Settings tab — Lets you change Debugger settings.
Attachable tab — Lets you add and remove debug-listing directories.

Font tab

The Font tab sets the Debugger font and size across all panes. Figure 3–19 shows the Font tab.

Figure 3–19: Preferences dialog box with Font tab

Settings tab

The Settings tab sets how long to pause between steps during animated stepping and whether to include line numbers in the source code pane.

Note: A change to the line number setting will take effect the next time the Debugger loads a new listing file.

Figure 3–20 shows the Settings tab.

Figure 3–20: Preferences dialog box with Settings tab

The Debugger automatically saves the following window settings:

Debugger window size and location (set by resizing or moving the Debugger window).
Size of the four window panes (set by resizing the panes).
Hidden panes (set by choosing one or more options on the View menu).

Attachable tab

The Attachable tab lists the debug listing directories. From this tab you can add and remove debug listing directories. The Debugger uses this list in attachable mode to locate the debug listing files. When the 4GL interpreter and the Debugger are on separate machines, the debug listing directories must be accessible to the Debugger machine via a mapped drive (Windows) or a mounted file system (UNIX).

Note: The Debugger working directory appears by default.

Figure 3–21 shows the Attachable tab.

Figure 3–21: Preferences dialog box with Attachable tab

The Generate debug listings on 4GL Interpreter machine toggle box indicates the 4GL will generate the listing files automatically (“on the fly”) and put them in the current listing directory. The default is the current working directory of the 4GL interpreter.

You can generate the debug listing files either manually or automatically. For more information on generating debug listing files, see the "Debug listing files" section.

The Debugger automatically opens the Preferences dialog box to this tab if it is unable to locate a listing file for the attached process, so that you can identify files are located. For more information, see the "Debug listing files" section.